home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d19 / wcb4m11.arc / WCB4M.DOC < prev    next >
Text File  |  1990-04-16  |  8KB  |  186 lines
  1. WCB4M - "Who Called Before Me?" PCBoard Utility (lists Recent Callers)
  2. version 1.10 (04-16-90) copyright 1989,1990 by DJ Chuang
  3. ----------------------------------------------------------------------
  4. This utility will generate a bulletin (or text file) which lists your
  5. most recent callers.  The list will contain the login line that PCBoard
  6. records in the caller log, containing the date and time of login, user
  7. name, baud rate, city & state (or New User), and minutes used.  Now with
  8. automatic multi-node support, a separate column will be made for node
  9. number.
  10.  
  11. This utility should work for all PCBoard versions.  If I remember
  12. correctly, the caller log format has not changed (62 columns text
  13. terminated with CR/LF).
  14.  
  15. ----- Setup Notes -----
  16.  
  17. - In the PCBSETUP Option #1 menu, set the switch to exit to Dos after
  18.   each caller to Y.  This is so that WCB4M will be executed after every
  19.   caller.  [Alternative:  you might be able to get away with not
  20.   dropping to DOS between users, but with the latest in PCBoard
  21.   technology, chances are that users will open an external DOOR program
  22.   while they're online.  In this case, you can just call WCB4M before or
  23.   after the PCBOARD.EXE call in the BOARD.BAT, and when a door is opened
  24.   or an event is run, WCB4M will update the bulletin.  Only caution is
  25.   that there may be an occasion when two users back-to-back will login
  26.   without opening a door, in which case WCB4M may miss a caller entry..]
  27.  
  28. - Edit your BOARD.BAT to contain a call to this program.  The program is
  29.   written so that there's a way to both re-execute the BBS and to exit
  30.   to DOS, as a normal F1 would do in BOARD.BAT.  My section of the
  31.   BOARD.BAT after the PCBoard portion looks like this:
  32.  
  33.      wcb4m c:\pcb\main\caller c:\pcb\gen\blt4 20 -r
  34.      pcboard
  35.      wcb4m c:\pcb\main\caller c:\pcb\gen\blt4 20 -f
  36.      if errorlevel 2 goto quit
  37.      
  38.      if exist door.bat door
  39.      if exist remote.bat remote
  40.      if exist event.bat event
  41.      if exist endpcb goto end
  42.      board
  43.      
  44.      :end
  45.      del endpcb
  46.      echo Type BOARD to restart PCBoard
  47.  
  48.  
  49. ----- Command Line Options -----
  50.  
  51.   The command line options can be seen by executing the WCB4M program
  52.   without any parameters.  
  53.  
  54.   The first parameter is the path and filename to your caller log.  
  55.  
  56.   The second parameter is the bulletin (or news) where you wish the
  57.   output of this to go.
  58.  
  59.   The third parameter is optional - and it represents how many previous
  60.   callers you wish to list in the bulletin.  The default is 20.
  61.  
  62.   The fourth parameter are switches for the WCB4M program.  If you wish
  63.   to use the default number of previous callers to list, you can make
  64.   this options parameter the third item on the command line.
  65.  
  66.   Four options are available for WCB4M in this version.  More than one
  67.   option may be specified at once. (not sure what happens if two
  68.   colliding options are selected, so don't try it)
  69.  
  70.   Specifying the "I" switch will generate the bulletin for the first
  71.   time to fill it up with 20 entries (or how ever many you specify).
  72.   Subsequent execution of this program will simply pick up the last
  73.   caller, and insert it in the bulletin keeping its reverse
  74.   chronological order. (the program is smart enough not to list the same
  75.   person twice.)  So this switch should only be used manually to
  76.   initialize the bulletin and not in the BOARD.BAT.
  77.  
  78.   The "F" switch will speed up the pause after the WCB4M bulletin is
  79.   generated.  This pause is there so that if this is the only program
  80.   you run between users, you have a chance to abort the batch file to
  81.   exit to DOS as the F1 from the call waiting screen should do.  The
  82.   way PCBoard and BOARD.BAT is structured, this program is run every time
  83.   that PCBoard exits, whether to DOS via F1 or F10, or between callers.
  84.  
  85.   The "R" switch turns off the above mentioned pause.  This will probably
  86.   be used by those running HSTRESET for their modems, which has its own
  87.   pause for the sysop to abort the BOARD.BAT.
  88.  
  89.   The "S" switch turns on File Share checking.  It's not really share
  90.   checking, but it will retry seven times if the file is not available
  91.   (when file access is denied on a network).  Version 1.10 will slightly
  92.   hesitate in hopes that the staggered access to networked files will
  93.   become available in due time.
  94.  
  95.   An errorlevel 2 is generated after the program execution if the F1
  96.   abort key was pressed.  Errorlevel 0 is returned if everything went as
  97.   it expected.  In version 1.10+, you can also hit the space bar, X, or
  98.   E to exit the WCB4M program. (these keys were added for Prologon
  99.   "support", so if you want to drop to DOS from the BBS, hit "X" twice)
  100.  
  101.   Multi-node support is available in version 1.10+.  WCB4M will
  102.   automatically detect a multi-node entry in the caller log, and make an
  103.   extra column in the bulletin for node number.  The city/state column
  104.   will be shortened to make room to list the number of the node that a
  105.   person called in on.
  106.  
  107.   There is not special WCB4M initialization for multi-node systems --
  108.   to initialize a bulletin, just use the caller log from your most
  109.   active node, and after a day or less, the bulletin will contain
  110.   entries from all your nodes equally.  The reason there is not an
  111.   initialization process for multi-node systems is to keep the code size
  112.   to a minimum.
  113.  
  114.   This upgrade is a "drop in" replacement for the old code, even for
  115.   multi-node systems.
  116.  
  117. -----
  118. This software is FREE.  I know sysop'ing is a demanding position, and I
  119. recognize that a BBS operation requires many other expenses, such as
  120. monthly phone bills and registering mail doors.  I hope this software
  121. inspires other programmers to give back a portion of what BBSing has
  122. given to all of us.
  123.  
  124. The program is provided as-is.  You may freely use this software and are
  125. encouraged to upload it to other PCBoard systems (and encourage them to
  126. use it too).  You may NOT modify the program or charge for its
  127. distribution.
  128.  
  129. Please do contact me if you find any problems in using the software, or 
  130. you can call my support BBS to get a "clean" version.  I also check the
  131. DOORS conference on RIME network frequently.
  132.  
  133. DJ Chuang
  134. 3005 Sayre Drive
  135. Great Mills, MD  20634
  136.  
  137.  
  138. The latest version of this software can be obtained from:
  139.  
  140. Southern Maryland Christian Info Service
  141. (301)862-3160
  142. 300/1200/2400/9600/38400 USR HST
  143. sysop: Buggs Bugnon
  144. RIME (RelayNet) node: SMCIS
  145.  
  146. ----- Acknowledgements -----
  147.  
  148. Jesus Christ, my Lord and Savior - for giving me life that 
  149.               I might have it abundantly.  To God be the Glory!
  150.               (Revelation 3:20-21)
  151.  
  152.  
  153. ----- Release History -----
  154.  
  155. v1.10  (04-16-90) Added multi-node support.  Also, file sharing retries
  156.                   will wait a random time period in hopes to wait out
  157.                   another node's file access to WCB4M bulletin.
  158.  
  159. v1.05  (10-06-89) Added "S" parameter in command line, to make file share
  160.                   retries an Option (rather than the rule).
  161.  
  162. v1.04  (10-05-89) Fixed intricacies for handling MarkMail as well as
  163.                   QwikMail local door entry.  Also, watch for file
  164.                   sharing violation, and will automatically retry up
  165.                   to seven times until other node(s) are finished writing
  166.                   to the WCB4M bulletin.
  167.  
  168. v1.03  (09-14-89) Fixed error in initializing WCB4M bulletin.
  169.                   Thanks goes out to Rick Welshans of Arlington, VA.
  170.  
  171. v1.02  (09-14-89) Added keyboard check if "caller not logged off yet"
  172.                   or "no new caller". (so that F1 would exit to DOS if
  173.                   there was new caller log)
  174.  
  175. v1.01  (08-30-89) Fixed bug which caused duplicate entries.
  176.  
  177. v1.00  (08-29-89) Alternative format used to make the bulletin "neater",
  178.                   using columns and added column for minutes used. (have
  179.                   been busy, folks, that's why there's a gap between
  180.                   these updates)
  181.  
  182. v0.60  (04-23-89) First public release.  Removed dependence on TP5's CRT
  183.                   unit, so it should no longer lock up multi-taskers (if it
  184.                   ever did.)  Code size reduced a little bit more.
  185.  
  186.